home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 020a / gdscrp11.zip / GIFDSCRP.DOC < prev    next >
Text File  |  1991-07-10  |  7KB  |  163 lines
  1.  
  2.  
  3.  
  4.  
  5.                     Welcome to GIF Descriptor V1.1(7/10/91)
  6.                                 by Rollin White
  7.  
  8.  
  9.         INTRODUCTION
  10.  
  11.             GIF Descriptor is a pair of utilities that reads and writes
  12.         descriptions of your .GIF files.  Adding descriptions using
  13.         GIFWRITE does not interfere with the image itself and completely
  14.         complies with the Compuserve GIF 89a and 87a specification.
  15.         These utilities are useful under many circumstances.  First,
  16.         when uploading a file, you no longer have to shell to your
  17.         viewer and bring up the GIF to remember exactly what the GIF is,
  18.         the description is more easily available.  Second when searching
  19.         through your collection, it is much easier to find that picture
  20.         you are looking for when you have descriptions to read instead
  21.         of just filenames.  This is especially helpful if you have 100's
  22.         or 1000's of GIFs(like D.D.).  Let's face it 8 characters is not
  23.         a lot of space to describe a picture.  Finally this may be of
  24.         use to SysOps since the descriptions can be exported into a
  25.         PCB/GAP formatted directory file, which can be incorporated into
  26.         your filebase  Users may also find this useful to print out a
  27.         list of your files.
  28.  
  29.  
  30.         HOW TO USE THE GIF DESCRIPTOR UTILITIES
  31.  
  32.             There are two programs that make up the GIF Descriptor
  33.         utilities GW and GD which stand for GIFWRITE and GIF DIR
  34.         respectively.  The process begins by running GW which adds the
  35.         actual comments to the file.  Then GD allows you to have
  36.         directory of your GIFs including their comments.  A detailed
  37.         description of each utility follows.
  38.  
  39.         GW(GIFWRITE)
  40.  
  41.             To start GW use the following command line syntax:
  42.  
  43.         GW <d:\path\filespec> <-v>
  44.  
  45.             Where d is stands for any valid drive, path is any valid
  46.         path, and filespec is either a valid file or a valid set of
  47.         wildcards.  An example is:
  48.  
  49.         GW e:\gifs\*.*
  50.  
  51.             Drive letter and path are optional, but you must include a
  52.         filespec whether it involves wildcards or is and exact file
  53.         name.
  54.  
  55.             Once GW finds a file it takes one of two courses of action.
  56.         If the file is not a GIF file it lists the name and tells you
  57.         that it is not a GIF file.  This might be the scenario if you
  58.         were to use the "*.*" filespec.
  59.  
  60.             If the file is a valid GIF file, GW informs you of the file
  61.         name and its current description.  If the file has no
  62.         description or if GW has not been run on the file before GW will
  63.         provide a description of "No description given".  You will then
  64.         be prompted to enter your new description of thirty characters
  65.         or less.  You also have the option of pressing enter which leaves
  66.         the current description unchanged.  An example is given below:
  67.  
  68.         The current description for CAT85.GIF is:No description given
  69.         Enter your new description or press Enter for no change.
  70.                                      <-30 limit of 30 characters or less
  71.  
  72.             As you can see everything is pretty straight forward.  This
  73.         process will continue for every file that qualifies under
  74.         filespec.
  75.  
  76.  
  77.                 The -v option stands for viewer.  This will invoke the
  78.         Vpic .GIF viewer each time GW finds a valid .GIF file.  This
  79.         allows you to easily view the picture before describing it.
  80.         VPIC must be in your path.  Support for other viewers will be
  81.         added in future revisions.
  82.  
  83.  
  84.         GD(GIF DIR)
  85.  
  86.             GD provides a directory of files including name, size,
  87.         dimensions, and description.  The command line syntax for GD is:
  88.  
  89.         GD <d:\path\filespec> <-wd:\path\file>
  90.  
  91.         Where d represents drive letter, path represents any valid path,
  92.         and filespec represents and valid DOS filespec.  If no
  93.         parameters are given, GD will use the current directory.  If the
  94.         number of files requires more space than is available on the
  95.         screen, GD will pause with a "--more--" prompt waiting for any
  96.         key to be pressed.
  97.  
  98.         The -w option will write a PCB/GAP file list to the specified
  99.         file.  Note that there are no spaces between the "-w" and the
  100.         file.  The pause between each screenful is turned off for this
  101.         option.  The resolution of the image is put into the description
  102.         and is right justified at 77 characters.
  103.  
  104.         REGISTRATION
  105.  
  106.                 This program is SHAREWARE.  If you decide that you like
  107.         this program and it is useful to you, please register it.
  108.         The cost of registration is a one time fee of $10.  If you
  109.         register you will receive a KEY file which will register all
  110.         future versions of the program.  On registered versions, the
  111.         final screen of GW is not present.  If you decide to register,
  112.         please fill out the form in the file REGISTER.TXT and mail it
  113.         to the address below.
  114.  
  115.         COMMENTS
  116.  
  117.             All comments and criticisms are appreciated.  What can I do
  118.         to make this better?  Do you have ideas for other programs?  I
  119.         WANT TO KNOW!  I can be reached my mail at the address below or
  120.         at CES BBS at (714)-968-3143 which operates from 8 PM. to 8 AM.
  121.  
  122.         Please send all registration and comments to:
  123.  
  124.                                 Rollin White
  125.                                 20222 Windcave Ln.
  126.                                 Huntington Beach, Ca. 92646-5341.
  127.  
  128.         Thank you for your support and comments.
  129.  
  130.         Graphic Interchange Format(GIF) is a registered trademark of
  131.         Compuserve Inc.
  132.  
  133.         VPIC is shareware.  If you use this utility, please register it.
  134.  
  135.  
  136.  
  137.                                     WARRANTY
  138.  
  139.  
  140.         THIS  SOFTWARE PROGRAM  AND DOCUMENTATION IS  BEING OFFERED FOR
  141.         EVALUATION PURPOSES "AS IS" AND WITHOUT WARRANTIES AS
  142.         TO PERFORMANCE.  BY USING THIS SET OF PROGRAMS YOU ARE EXPRESSLY
  143.         RELEASING THE AUTHOR FROM ANY LIABILITY RESULTING
  144.         FROM THE USE OF THIS SOFTWARE AND DOCUMENTATION.  THE USER MUST
  145.         ASSUME THE ENTIRE RISK OF USING THIS SOFTWARE.
  146.  
  147.  
  148.  
  149.                                LICENSE AGREEMENT
  150.  
  151.         1.  These programs(GW and GD) are being distributed as
  152.         Shareware.  You may evaluate them for a period of 21 days.
  153.         After that, if you continue to use them you must register them
  154.         by filling out the form REGISTER.TXT.
  155.  
  156.         2.  You may make as many copies as you'd like for personal use.
  157.         You may also freely distribute them to other BBSs and your
  158.         friends.
  159.  
  160.         3.  You may NOT receive compensation, monetary or otherwise for
  161.         distributing this software including the cost of storage
  162.         medium(disks).
  163.